<!DOCTYPE html>
<html lang="en-US">
    <head>
        <title>Net::Ping::External - Cross-platform Perl interface to &quot;ping&quot; utilities - metacpan.org</title>
        <link rel="preload" as="fetch" href="https://metacpan.org/account/login_status" crossorigin="anonymous" />
        <link href="https://metacpan.org/_assets/b8ccceeed47a0652049703d99326a9cea4933443.css" rel="stylesheet" type="text/css">
        <script src="https://metacpan.org/_assets/6bfedafe2d7caa915b7d84f61b45936818e3242e.js" type="text/javascript" defer></script>
        <link rel="alternate" type="application/rss+xml" title="Recent CPAN Uploads of Net-Ping-External - MetaCPAN" href="https://metacpan.org/dist/Net-Ping-External/releases.rss" />
        <link rel="canonical" href="./Net::Ping::External.html" />
        <meta name="description" content="Cross-platform Perl interface to &quot;ping&quot; utilities" />
        <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=5">
        <link rel="shortcut icon" href="https://metacpan.org/static/icons/favicon.ico">
        <link rel="apple-touch-icon" sizes="152x152" href="https://metacpan.org/static/icons/apple-touch-icon.png">
        <link rel="search" href="https://metacpan.org/static/opensearch.xml" type="application/opensearchdescription+xml" title="MetaCPAN">
        <script>
          (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
          (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
          m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
          })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

          (function(skey, ga_id){
            ga('create', ga_id, {
              siteSpeedSampleRate : 100,
              storage             : 'none',
              clientId            : localStorage.getItem(skey)
            });
            ga(function(tracker) {
              localStorage.setItem(skey, tracker.get('clientId'));
            });
            ga('send', 'pageview');
          })('ga:clientId', 'UA-27829474-1');
        </script>
<meta name="twitter:card"        content="summary" />
<meta name="twitter:url"         content="https://metacpan.org/pod/Net::Ping::External" />
<meta name="twitter:title"       content="Net::Ping::External" />
<meta name="twitter:description" content="Cross-platform Perl interface to &quot;ping&quot; utilities" />
<meta name="twitter:site"        content="metacpan" />
    </head>
    <body>
        <nav class="navbar navbar-default" role="navigation">
            <div class="header-logo-large hidden-xs">
              <a href="https://metacpan.org/" tabindex="0">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#logo" />
                </svg>
              </a>
            </div>
            <div class="header-logo-icon visible-xs">
              <a href="https://metacpan.org/">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#dots" />
                </svg>
              </a>
            </div>
            <ul class="nav navbar-nav menu-items hidden-xs hidden-sm">
              <li><a href="https://metacpan.org/about">About</a></li>
              <li><a href="https://metacpan.org/about/sponsors">Sponsor</a></li>
              <li><a href="https://grep.metacpan.org/">grep::cpan</a></li>
              <li><a href="https://metacpan.org/recent">Recent</a></li>
              <li><a href="https://metacpan.org/about/faq">FAQ</a></li>
              <li><a href="https://metacpan.org/tools">Tools</a></li>
              <li><a href="https://fastapi.metacpan.org/">API</a></li>
            </ul>
            <ul class="nav navbar-nav navbar-right">
                <button type="button" class="searchbar-btn visible-xs visible-sm">
                    <i class="fa fa-search button-fa-icon"></i>
                </button>
                <form action="https://metacpan.org/search" class="searchbar-form visible-md visible-lg search-form form-horizontal">
                   <input type="hidden" name="size" id="metacpan_search-size" value="20">
                  <div class="form-group">
                      <div class="search-group">
                        <i class="fa fa-search"></i>
                        <input type="text" name="q" placeholder="Search the CPAN" size="41" autocorrect="off" autocapitalize="off" spellcheck="false" id="metacpan_search-input" class="form-control" value="">
                      </div>
                  </div>
                </form>
                    <li class="icon-slidepanel visible-xs visible-sm">
                      <button data-toggle="slidepanel" data-target=".slidepanel">
                        <span class="button-fa-icon">
                          <i class="fa fa-bars slidepanel-open"></i>
                          <i class="fa fa-times slidepanel-close"></i>
                        </span>
                      </button>
                    </li>
                <form action="https://metacpan.org/account/logout" method="POST" id="metacpan-logout"></form>
                <li class="dropdown logged_in" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon logged-in-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li><a href="https://metacpan.org/account/identities">Identities</a></li>
                        <li><a href="https://metacpan.org/account/profile">Profile</a></li>
                        <li><a href="https://metacpan.org/account/favorite/list">Favorites</a></li>
                        <li>
                            <a href="./Net::Ping::External.html#" type="button" onclick="$('#metacpan-logout').submit(); return false">
                              Logout
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_out" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li>
                            <a href="https://metacpan.org/login/github">
                                <i class="fab fa-github fa-fw"></i>
                                GitHub
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/twitter">
                                <i class="fab fa-twitter fa-fw"></i>
                                Twitter
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/google">
                                <i class="fab fa-google fa-fw"></i>
                                Google
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_placeholder">
                    <button>
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                    </button>
                </li>
            </ul>
        </nav>
        <div class="page-content ">
          <!--
          <div class="top-notify-banner">
            <i class="fas fa-info-circle"></i>
          </div>
          -->
          <nav class="sidebar">
            <div class="slidepanel">
              <ul class="nav-list ">
    <li class="nav-header no-margin-top">
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The date that this version of Net-Ping-External was released.">
      <span class="relatize">12 Apr 2014 21:37:12 UTC</span>
    </li>
  <li>
    Distribution: <a href="https://metacpan.org/dist/Net-Ping-External">Net-Ping-External</a>
  </li>
  <li>
    Module version: 0.15
  </li>
  <li>
    <a data-keyboard-shortcut="g s" href="https://metacpan.org/dist/Net-Ping-External/source/External.pm">Source</a>
    (<a href="https://metacpan.org/dist/Net-Ping-External/source/External.pm?raw=1">raw</a>)
  </li>
  <li>
    <a data-keyboard-shortcut="g b" href="https://metacpan.org/dist/Net-Ping-External/source">Browse</a>
    (<a href="https://metacpan.org/dist/Net-Ping-External/source?raw=1">raw</a>)
  </li>
    <li>
      <a data-keyboard-shortcut="g c" href="https://metacpan.org/dist/Net-Ping-External/changes">Changes</a>
    </li>
    <li>
      <a class="nopopup" href="https://metacpan.org/dist/Net-Ping-External/contribute">How to Contribute</a>
    </li>
    <li>
        <a rel="noopener nofollow" data-keyboard-shortcut="g r" href="https://github.com/chorny/Net-Ping-External">Repository</a>
    </li>
    <li>
      <a rel="noopener nofollow" data-keyboard-shortcut="g i" href="https://rt.cpan.org/Public/Dist/Display.html?Name=Net-Ping-External">Issues</a>
      (6)
    </li>
    <li>
      <a rel="noopener nofollow" href="http://matrix.cpantesters.org/?dist=Net-Ping-External+0.15" title="Matrix">Testers</a>
        <span title="(pass / fail / na)">(<a rel="noopener nofollow" href="https://www.cpantesters.org/distro/N/Net-Ping-External.html?oncpan=1&amp;distmat=1&amp;version=0.15&amp;grade=2" style="color: #090">47</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/N/Net-Ping-External.html?oncpan=1&amp;distmat=1&amp;version=0.15&amp;grade=3" style="color: #900">3</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/N/Net-Ping-External.html?oncpan=1&amp;distmat=1&amp;version=0.15&amp;grade=4">0</a>)</span>
    </li>
    <li>
      <a rel="noopener nofollow" href="http://cpants.cpanauthors.org/release/CHORNY/Net-Ping-External-0.15">Kwalitee</a>
    </li>
    <li>
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The # people with an indexing permission on Net-Ping-External who have released something to CPAN in the last 2 years (i.e. the # people likely able to release critical fixes in a timely manner)">
      Bus factor: 0
      </div>
    </li>
    <li>
      <a rel="noopener nofollow" href="http://cpancover.com/latest/Net-Ping-External-0.15/index.html">31.79% Coverage </a>
    </li>
    <li>
      License: perl_5
    </li>
    <li class="nav-header">Activity</li>
    <li>
<div class="activity-graph">
    <img src="https://metacpan.org/dist/Net-Ping-External/activity.svg?res=month" />
    <div class="comment">24 month</div>
</div>
    </li>
    <li class="nav-header">Tools</li>
    <li>
      <a itemprop="downloadUrl" href="https://cpan.metacpan.org/authors/id/C/CH/CHORNY/Net-Ping-External-0.15.tar.gz">
      Download (<span itemprop="fileSize">8.81KB</span>)</a>
    </li>
    <li>
      <a href="https://explorer.metacpan.org/?url=%2Fmodule%2FCHORNY%2FNet-Ping-External-0.15%2FExternal.pm">
        MetaCPAN Explorer
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/Net-Ping-External/permissions">
        Permissions
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/Net-Ping-External/releases.rss">
        Subscribe to distribution
      </a>
    </li>
    <li>
      <button class="btn btn-link" data-toggle="modal" data-target="#metacpan_install-instructions-dialog">
        Install Instructions
      </button>
    </li>
    <li>
      <form action="https://metacpan.org/search">
        <input type="hidden" name="q" value="dist:Net-Ping-External">
        <input type="search" name="q" placeholder="Search distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
      </form>
    </li>
    <li>
      <form action="https://grep.metacpan.org/search">
        <input type="hidden" name="qd" value="Net-Ping-External">
        <input type="hidden" name="source" value="metacpan">
        <input type="search" name="q" placeholder="grep distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
     </form>
    </li>
    <li class="version-jump">
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/External.pm&#39;" class="form-control tool-bar-form">
  <option disabled selected>Jump to version</option>
<option
  disabled
  value="CHORNY/Net-Ping-External-0.15"
>0.15
  (CHORNY on 2014-04-12)</option>
<option
  
  value="CHORNY/Net-Ping-External-0.12"
>0.12
  (CHORNY on 2007-02-08)</option>
<option
  
  value="COLINM/Net-Ping-External-0.11"
>0.11
  (COLINM on 2003-02-11)</option>
<option
  
  value="COLINM/Net-Ping-External-0.10"
>0.10
  (COLINM on 2001-11-10)</option>
<option
  
  value="COLINM/Net-Ping-External-0.09"
>0.09
  (COLINM on 2001-11-10)</option>
<option
  
  value="COLINM/Net-Ping-External-0.08"
>0.08
  (COLINM on 2001-09-30)</option>
<option
  
  value="COLINM/Net-Ping-External-0.07"
>0.07
  (COLINM on 2001-09-28)</option>
<option
  
  value="COLINM/Net-Ping-External-0.06"
>0.06
  (COLINM on 2001-04-26)</option>
<option
  
  value="COLINM/Net-Ping-External-0.05"
>0.05
  (COLINM on 2001-04-20)</option>
<option
  
  value="COLINM/Net-Ping-External-0.04"
>0.04
  (COLINM on 2001-04-20)</option>
<option
  
  value="COLINM/Net-Ping-External-0.03"
>0.03
  (COLINM on 2001-03-23)</option>
<option
  
  value="COLINM/Net-Ping-External-0.02"
>0.02
  (COLINM on 2001-03-22)</option>
<option
  
  value="COLINM/Net-Ping-External-0.01"
>0.01
  (COLINM on 2001-03-15)</option>
<optgroup label="BackPAN">'
<option
  
  value="CHORNY/Net-Ping-External-0.14"
>0.14
  (CHORNY on 2013-10-29)</option>
<option
  
  value="CHORNY/Net-Ping-External-0.13"
>0.13
  (CHORNY on 2008-12-18)</option>
<option
  
  value="CHORNY/Net-Ping-External-0.12_02"
>0.12_02 DEV
  (CHORNY on 2007-01-31)</option>
<option
  
  value="CHORNY/Net-Ping-External-0.12_01"
>0.12_01 DEV
  (CHORNY on 2006-09-07)</option>
</optgroup>
</select>
    </li>
    <li class="version-diff">
<select onchange="document.location.href='/release/CHORNY/Net-Ping-External-0.15/diff/' + encodeURIComponent(this.value) + '/External.pm'
" class="form-control tool-bar-form">
  <option disabled selected>Diff with version</option>
<option
  disabled
  value="CHORNY/Net-Ping-External-0.15"
>0.15
  (CHORNY on 2014-04-12)</option>
<option
  
  value="CHORNY/Net-Ping-External-0.12"
>0.12
  (CHORNY on 2007-02-08)</option>
<option
  
  value="COLINM/Net-Ping-External-0.11"
>0.11
  (COLINM on 2003-02-11)</option>
<option
  
  value="COLINM/Net-Ping-External-0.10"
>0.10
  (COLINM on 2001-11-10)</option>
<option
  
  value="COLINM/Net-Ping-External-0.09"
>0.09
  (COLINM on 2001-11-10)</option>
<option
  
  value="COLINM/Net-Ping-External-0.08"
>0.08
  (COLINM on 2001-09-30)</option>
<option
  
  value="COLINM/Net-Ping-External-0.07"
>0.07
  (COLINM on 2001-09-28)</option>
<option
  
  value="COLINM/Net-Ping-External-0.06"
>0.06
  (COLINM on 2001-04-26)</option>
<option
  
  value="COLINM/Net-Ping-External-0.05"
>0.05
  (COLINM on 2001-04-20)</option>
<option
  
  value="COLINM/Net-Ping-External-0.04"
>0.04
  (COLINM on 2001-04-20)</option>
<option
  
  value="COLINM/Net-Ping-External-0.03"
>0.03
  (COLINM on 2001-03-23)</option>
<option
  
  value="COLINM/Net-Ping-External-0.02"
>0.02
  (COLINM on 2001-03-22)</option>
<option
  
  value="COLINM/Net-Ping-External-0.01"
>0.01
  (COLINM on 2001-03-15)</option>
<optgroup label="BackPAN">'
<option
  
  value="CHORNY/Net-Ping-External-0.14"
>0.14
  (CHORNY on 2013-10-29)</option>
<option
  
  value="CHORNY/Net-Ping-External-0.13"
>0.13
  (CHORNY on 2008-12-18)</option>
<option
  
  value="CHORNY/Net-Ping-External-0.12_02"
>0.12_02 DEV
  (CHORNY on 2007-01-31)</option>
<option
  
  value="CHORNY/Net-Ping-External-0.12_01"
>0.12_01 DEV
  (CHORNY on 2006-09-07)</option>
</optgroup>
</select>
    </li>

    <li>
<ul class="dependencies">
  <li class="nav-header">Dependencies</li>
  <li><a href="https://metacpan.org/pod/Carp" title="Carp" class="ellipsis">Carp</a></li>
  <li><a href="https://metacpan.org/pod/Socket" title="Socket" class="ellipsis">Socket</a></li>
  <li><i class="ttip" title="dynamic_config enabled">and possibly others</i></li>
  <li>
    <hr>
  </li>
  <li>
    <a href="https://metacpan.org/module/Net::Ping::External/requires">Reverse dependencies</a>
  </li>
  <li>
    <a href="http://deps.cpantesters.org/?module=Net%3A%3APing%3A%3AExternal">CPAN Testers List</a>
  </li>
  <li>
    <a href="https://cpandeps.grinnz.com/?dist=Net-Ping-External">Dependency graph</a>
  </li>
</ul>
    </li>
    <li class="nav-header">Permalinks</li>
    <li>
      <a href="https://metacpan.org/release/CHORNY/Net-Ping-External-0.15/view/External.pm">This version</a>
    </li>
    <li>
      <a href="./Net::Ping::External.html">Latest version</a>
    </li>
    <li>
<div class="plussers">
<div class="nav-header">++ed by:</div>
<div>
<a class="display-all" href="https://metacpan.org/author/PINGAN"><img src="https://www.gravatar.com/avatar/a02222e5e0e4fd24d52fc29a08ac6bcb?d=identicon&amp;s=20" title="PINGAN" alt="PINGAN"></a>
<a class="display-all" href="https://metacpan.org/author/DMOL"><img src="https://www.gravatar.com/avatar/78b28a931707c0fa696996adc7702db9?d=identicon&amp;s=20" title="DMOL" alt="DMOL"></a>
<a class="display-all" href="https://metacpan.org/author/MMUSGROVE"><img src="https://www.gravatar.com/avatar/c8d0367f59978d30016ef08c7a60b961?d=identicon&amp;s=20" title="MMUSGROVE" alt="MMUSGROVE"></a>
</div>
<!-- Display counts of plussers-->
<div>
    <a href="https://metacpan.org/dist/Net-Ping-External/plussers">3 PAUSE users</a>
</div>
<div>
    1 non-PAUSE user
</div>
</div>
    </li>
    <li>
    </li>
              </ul>
            </div>
          </nav>
          <div class="content-navigation">
<div class="breadcrumbs">
  <span>
    <a data-keyboard-shortcut="g a" rel="author" href="https://metacpan.org/author/CHORNY" class="author-name">Alexandr Ciornii</a>
  </span>
  <span>&nbsp;/&nbsp;</span>
  <div class="release dist-release status-latest maturity-released">
    <span class="dropdown"><b class="caret"></b></span>
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/External.pm&#39;" class="">
<option
  selected
  value="CHORNY/Net-Ping-External-0.15"
>0.15
  (CHORNY on 2014-04-12)</option>
<option
  
  value="CHORNY/Net-Ping-External-0.12"
>0.12
  (CHORNY on 2007-02-08)</option>
<option
  
  value="COLINM/Net-Ping-External-0.11"
>0.11
  (COLINM on 2003-02-11)</option>
<option
  
  value="COLINM/Net-Ping-External-0.10"
>0.10
  (COLINM on 2001-11-10)</option>
<option
  
  value="COLINM/Net-Ping-External-0.09"
>0.09
  (COLINM on 2001-11-10)</option>
<option
  
  value="COLINM/Net-Ping-External-0.08"
>0.08
  (COLINM on 2001-09-30)</option>
<option
  
  value="COLINM/Net-Ping-External-0.07"
>0.07
  (COLINM on 2001-09-28)</option>
<option
  
  value="COLINM/Net-Ping-External-0.06"
>0.06
  (COLINM on 2001-04-26)</option>
<option
  
  value="COLINM/Net-Ping-External-0.05"
>0.05
  (COLINM on 2001-04-20)</option>
<option
  
  value="COLINM/Net-Ping-External-0.04"
>0.04
  (COLINM on 2001-04-20)</option>
<option
  
  value="COLINM/Net-Ping-External-0.03"
>0.03
  (COLINM on 2001-03-23)</option>
<option
  
  value="COLINM/Net-Ping-External-0.02"
>0.02
  (COLINM on 2001-03-22)</option>
<option
  
  value="COLINM/Net-Ping-External-0.01"
>0.01
  (COLINM on 2001-03-15)</option>
<optgroup label="BackPAN">'
<option
  
  value="CHORNY/Net-Ping-External-0.14"
>0.14
  (CHORNY on 2013-10-29)</option>
<option
  
  value="CHORNY/Net-Ping-External-0.13"
>0.13
  (CHORNY on 2008-12-18)</option>
<option
  
  value="CHORNY/Net-Ping-External-0.12_02"
>0.12_02 DEV
  (CHORNY on 2007-01-31)</option>
<option
  
  value="CHORNY/Net-Ping-External-0.12_01"
>0.12_01 DEV
  (CHORNY on 2006-09-07)</option>
</optgroup>
</select>
    <a data-keyboard-shortcut="g d" class="release-name" href="https://metacpan.org/dist/Net-Ping-External">Net-Ping-External-0.15</a>
  </div>
<span class="river-gauge-gauge">
  <svg width="24px"
       height="15px"
       version="1.1"
       xmlns="http://www.w3.org/2000/svg"
       xmlns:xlink="http://www.w3.org/1999/xlink">

    <g>
      <title>        River stage one &#10;
          • 3 direct dependents &#10;          • 3 total dependents
      </title>

      <rect x="0"  y="0" width="4" height="15" fill="#7ea3f2" />
      <rect x="5"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="10"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="15"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="20"  y="0" width="4" height="15" fill="#e4e2e2" />
    </g>
  </svg>

</span>
<div id="Net-Ping-External-fav" class="logged_in">
<form action="https://metacpan.org/account/favorite/add" style="display: inline" onsubmit="return favDistribution(this)">
    <input type="hidden" name="remove" value="0">
    <input type="hidden" name="release" value="Net-Ping-External-0.15">
    <input type="hidden" name="author" value="CHORNY">
    <input type="hidden" name="distribution" value="Net-Ping-External">
    <button type="submit" class="favorite highlight"><span>4</span> ++</button>
</form>
</div>
<div class="logged_out">
<a href="./Net::Ping::External.html" onclick="alert('Please sign in to add favorites'); return false" class="favorite highlight">
<span>4</span> ++</a>
</div>
   / <span>Net::Ping::External</span>
</div>
          </div>
          <main class="content">


<nav class="toc">
  <div class="toc-header"><strong>Contents</strong></div>
<ul>
  <li><a href="./Net::Ping::External.html#NAME">NAME</a></li>
  <li><a href="./Net::Ping::External.html#SYNOPSIS">SYNOPSIS</a></li>
  <li><a href="./Net::Ping::External.html#DESCRIPTION">DESCRIPTION</a>
    <ul>
      <li><a href="./Net::Ping::External.html#ping()-OPTIONS">ping() OPTIONS</a></li>
      <li><a href="./Net::Ping::External.html#SUPPORTED-PLATFORMS">SUPPORTED PLATFORMS</a></li>
    </ul>
  </li>
  <li><a href="./Net::Ping::External.html#BUGS">BUGS</a></li>
  <li><a href="./Net::Ping::External.html#WARNING">WARNING</a></li>
  <li><a href="./Net::Ping::External.html#AUTHOR">AUTHOR</a></li>
  <li><a href="./Net::Ping::External.html#CREDITS">CREDITS</a></li>
  <li><a href="./Net::Ping::External.html#SEE-ALSO">SEE ALSO</a></li>
</ul></nav>
<div class="pod anchors">
<h1 id="NAME">NAME</h1>

<p>Net::Ping::External - Cross-platform Perl interface to &quot;ping&quot; utilities</p>

<h1 id="SYNOPSIS">SYNOPSIS</h1>

<p>In general:</p>

<pre><code>  use Net::Ping::External qw(ping);
  ping(%options);</code></pre>

<p>Some examples:</p>

<pre><code>  use Net::Ping::External qw(ping);

  # Ping a single host
  my $alive = ping(host =&gt; &quot;127.0.0.1&quot;);
  print &quot;127.0.0.1 is online&quot; if $alive;

  # Or a list of hosts
  my @hosts = qw(127.0.0.1 127.0.0.2 127.0.0.3 127.0.0.4);
  my $num_alive = 0;
  foreach (@hosts) {
    $alive = ping(hostname =&gt; $_, timeout =&gt; 5);
    print &quot;$_ is alive!\n&quot; if $alive;
    $num_alive++;
  }
  print &quot;$num_alive hosts are alive.\n&quot;;

  # Using all the fancy options:
  ping(hostname =&gt; &quot;127.0.0.1&quot;, count =&gt; 5, size =&gt; 1024, timeout =&gt; 3);</code></pre>

<h1 id="DESCRIPTION">DESCRIPTION</h1>

<p>Net::Ping::External is a module which interfaces with the &quot;ping&quot; command on many systems. It presently provides a single function, <code>ping()</code>, that takes in a hostname and (optionally) a timeout and returns true if the host is alive, and false otherwise. Unless you have the ability (and willingness) to run your scripts as the superuser on your system, this module will probably provide more accurate results than Net::Ping will.</p>

<p>Why?</p>

<ul>

<li><p>ICMP ping is the most reliable way to tell whether a remote host is alive.</p>

</li>
<li><p>However, Net::Ping cannot use an ICMP ping unless you are running your script with privileged (AKA &quot;root&quot;) access.</p>

</li>
<li><p>The system&#39;s &quot;ping&quot; command uses ICMP and does not usually require privileged access.</p>

</li>
<li><p>While it is relatively trivial to write a Perl script that parses the output of the &quot;ping&quot; command on a given system, the aim of this module is to encapsulate this functionality and provide a single interface for it that works on many systems.</p>

</li>
</ul>

<h2 id="ping()-OPTIONS"><a id="ping"></a><a id="ping--OPTIONS"></a>ping() OPTIONS</h2>

<p>This module is still &quot;alpha&quot;; it is expected that more options to the <code>ping()</code> function will be added soon.</p>

<ul>

<li><p><code>host, hostname</code></p>

<p>The hostname (or dotted-quad IP address) of the remote host you are trying to ping. You must specify either the &quot;hostname&quot; option or the &quot;ip&quot; option.</p>

<p>&quot;host&quot; and &quot;hostname&quot; are synonymous.</p>

</li>
<li><p><code>ip</code></p>

<p>A packed bit-string representing the 4-byte packed IP address (as returned by <code>Socket.pm</code>&#39;s <code>inet_aton()</code> function) of the host that you would like to ping.</p>

</li>
<li><p><code>timeout</code></p>

<p>The maximum amount of time, in seconds, that <code>ping()</code> will wait for a response. If the remote system does not respond before the timeout has elapsed, <code>ping()</code> will return false.</p>

<p>Default value: 5.</p>

</li>
<li><p><code>count</code></p>

<p>The number of ICMP ping packets to send to the remote host. Eventually, Net::Ping::External will return the number of packets that were acknowledged by the remote host; for now, however, <code>ping()</code> still returns just true or false.</p>

<p>Default value: 1.</p>

</li>
<li><p><code>size</code></p>

<p>Specifies the number of data bytes to be sent. The default is 56, which translates into 64 ICMP data bytes when combined with the 8 bytes of ICMP header data.</p>

<p>Default value: 56.</p>

</li>
</ul>

<h2 id="SUPPORTED-PLATFORMS"><a id="SUPPORTED"></a>SUPPORTED PLATFORMS</h2>

<p>Support currently exists for interfacing with the standard ping utilities on the following systems. Please note that the path to the `ping&#39; should be somewhere in your PATH environment variable (or your system&#39;s closest equivalent thereof.) Otherwise, Net::Ping::External will be unable to locate your system&#39;s `ping&#39; command.</p>

<ul>

<li><p>Win32</p>

<p>Tested OK on Win98, Win XP. It should work on other Windows systems as well.</p>

</li>
<li><p>Cygwin</p>

<p>Tested OK on Cygwin 1.5.21. Problem is that we may be running windows ping. They have different options.</p>

</li>
<li><p>Linux</p>

<p>Tested OK on Debian 2.2 and Redhat 6.2. It appears that different versions of Linux use different versions of ping, which support different options. Not sure how I&#39;m going to resolve this yet; for now, all the options but <code>count</code> are disabled.</p>

</li>
<li><p>BSD</p>

<p>Tested OK on OpenBSD 2.7 and 3.0, Netbsd 1.5.3, Freebsd 4.6.2, 5.4. Needs testing for BSDi.</p>

</li>
<li><p>Solaris</p>

<p>Tested OK on Solaris 2.6 and 2.7.</p>

</li>
<li><p>IRIX</p>

<p>Tested OK on IRIX 6.5.</p>

</li>
<li><p>AIX, DEC OSF, UNICOSMK, NeXTStep, HP-UX, BSD/OS (BSDi), BeOS</p>

<p>Support for these systems is integrated into this module but none have been tested yet. If you have successful or unsuccessful test results for any of these systems, please send them to me. On some of these systems, some of the arguments may not be supported. If you&#39;d like to see better support on your system, please e-mail me.</p>

</li>
</ul>

<p>More systems will be added as soon as any users request them. If your system is not currently supported, e-mail me; adding support to your system is probably trivial.</p>

<h1 id="BUGS">BUGS</h1>

<p>This module should be considered beta. Bugs may exist. Although no specific bugs are known at this time, the module could use testing on a greater variety of systems.</p>

<p>See the warning below.</p>

<h1 id="WARNING">WARNING</h1>

<p>This module calls whatever &quot;ping&quot; program it first finds in your PATH environment variable. If your PATH contains a trojan &quot;ping&quot; program, this module will call that program. This involves a small amount of risk, but no more than simply typing &quot;ping&quot; at a system prompt.</p>

<p>Beware Greeks bearing gifts.</p>

<h1 id="AUTHOR">AUTHOR</h1>

<p>Alexandr Ciornii (alexchorny AT gmail.com), Colin McMillen (colinm AT cpan.org)</p>

<p>This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.</p>

<h1 id="CREDITS">CREDITS</h1>

<p>Dan Moore contributed command-line options and code for NeXT, BeOS, HP-UX, and BSD/OS.</p>

<p>Jarkko Hietaniemi contributed a huge list of command-line options and results for the `ping&#39; command on 9 different systems.</p>

<p>Randy Moore contributed several patches for Win32 support.</p>

<p>Marc-Andre Dumas contributed a patch for FreeBSD support.</p>

<p>Jonathan Stowe fixed a bug in 0.09 that prevented the module from running on some systems.</p>

<p>Numerous people sent in a patch to fix a bug in 0.10 that broke ping on Windows systems.</p>

<p>Peter N. Lewis contributed a patch that works correctly on Mac OS X 10.2 (and hopefully other versions as well).</p>

<h1 id="SEE-ALSO"><a id="SEE"></a>SEE ALSO</h1>

<p>Net::Ping</p></div>

<div id="metacpan_install-instructions-dialog" class="modal fade">
  <div class="modal-dialog">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
        <h4 class="modal-title">Module Install Instructions</h4>
      </div>
      <div class="modal-body">
        <p>To install Net::Ping::External, copy and paste the appropriate command in to your terminal.</p>
        <p><a href="https://metacpan.org/dist/App-cpanminus/view/bin/cpanm">cpanm</a></p>
        <pre><code>cpanm Net::Ping::External</code></pre>
        <p><a href="https://metacpan.org/pod/CPAN">CPAN shell</a></p>
        <pre><code>perl -MCPAN -e shell
install Net::Ping::External</code></pre>
        <p>For more information on module installation, please visit <a href="https://www.cpan.org/modules/INSTALL.html">the detailed CPAN module installation guide</a>.</p>
      </div>
      <div class="modal-footer">
        <a href="./Net::Ping::External.html#" data-dismiss="modal" class="btn">Close</a>
      </div>
    </div>
  </div>
</div>
          </main>
          <div class="content-pagination">
          </div>
        </div>
        <footer class="footer">
          <div class="footer-container">
            <div class="footer-social">
              <div class="footer-link footer-logo">
                <a href="https://metacpan.org/">
                  <img src="https://metacpan.org/static/images/metacpan-logo.svg" alt="MetaCPAN" />
                </a>
              </div>
              <a class="footer-social-link" href="https://github.com/metacpan">
                <i class="fab fa-github-square"></i>
              </a>
              <a class="footer-social-link" href="https://fosstodon.org/@metacpan">
                <i class="fab fa-mastodon"></i>
              </a>
            </div>
            <div class="footer-links">
              <div class="footer-link">
                  <a href="https://metacpan.org/about">About</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/sponsors">Sponsor</a>
              </div>
              <div class="footer-link">
                  <a href="https://grep.metacpan.org">grep::cpan</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/recent">Recent</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/faq">FAQ</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/tools">Tools</a>
              </div>
              <div class="footer-link">
                  <a href="https://fastapi.metacpan.org/">API</a>
              </div>
              <div class="footer-link">
                  <a href="https://www.perl.org/">Perl.org</a>
              </div>
            </div>
            <div class="footer-sponsors">
              <a class="footer-sponsor-link" target="_blank" href="https://www.bytemark.co.uk/" rel="noopener">
                <img class="footer-sponsor-bytemark" src="https://metacpan.org/static/images/sponsors/bytemark_logo.svg" alt="Bytemark logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.liquidweb.com/" rel="noopener">
                <img class="footer-sponsor-liquidweb" src="https://metacpan.org/static/images/sponsors/liquidweb_logo.png" alt="liquidweb logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://deriv.com/careers/" rel="noopener">
                <img class="footer-sponsor-deriv" src="https://metacpan.org/static/images/sponsors/deriv.svg" alt="Deriv logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://geocode.xyz" rel="noopener">
                <img class="footer-sponsor-geocode" src="https://metacpan.org/static/images/sponsors/geocodelogo.svg" alt="Geocode logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.fastly.com/" rel="noopener">
                <img class="footer-sponsor-fastly" src="https://metacpan.org/static/images/sponsors/fastly_logo.svg" alt="Fastly logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://opencagedata.com" rel="noopener">
                <img class="footer-sponsor-opencage" src="https://metacpan.org/static/images/sponsors/open-cage.svg" alt="OpenCage logo">
              </a>
            </div>
          </div>
        </footer>
        <div class="modal fade" tabindex="-1" role="dialog" id="metacpan_keyboard-shortcuts">
          <div class="modal-dialog">
            <div class="modal-content">
              <div class="modal-header">
                <button type="button" class="close" data-dismiss="modal">&times;</button>
                <h4 class="modal-title">Keyboard Shortcuts</h4>
              </div>
              <div class="modal-body row">
<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Global</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>s</kbd>
        </td>
        <td>Focus search bar</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>?</kbd>
        </td>
        <td>Bring up this help dialog</td>
      </tr>
    </tbody>
  </table>

  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>GitHub</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>p</kbd>
        </td>
        <td>Go to pull requests</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>go to github issues (only if github is preferred repository)</td>
      </tr>
    </tbody>
  </table>
</div>

<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>POD</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>a</kbd>
        </td>
        <td>Go to author</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>c</kbd>
        </td>
        <td>Go to changes</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>Go to issues</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>d</kbd>
        </td>
        <td>Go to dist</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>r</kbd>
        </td>
        <td>Go to repository/SCM</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>s</kbd>
        </td>
        <td>Go to source</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>b</kbd>
        </td>
        <td>Go to file browse</td>
      </tr>

    </tbody>
  </table>
</div>

<div class="col-md-12">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Search terms</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td><em>module:</em> (e.g. <a href="https://metacpan.org/search?q=module%3APlugin">module:Plugin</a>)</td>
      </tr>
      <tr>
        <td><em>distribution:</em> (e.g. <a href="https://metacpan.org/search?q=distribution%3ADancer+auth">distribution:Dancer auth</a>)</td>
      </tr>
      <tr>
        <td><em>author:</em> (e.g. <a href="https://metacpan.org/search?q=author%3ASONGMU+Redis">author:SONGMU Redis</a>)</td>
      </tr>
      <tr>
        <td><em>version:</em> (e.g. <a href="https://metacpan.org/search?q=version%3A1.00">version:1.00</a>)</td>
      </tr>
    </tbody>
  </table>
</div>
              </div>
              <div class="modal-footer"></div>
            </div>
          </div>
        </div>
    </body>
</html>
